home *** CD-ROM | disk | FTP | other *** search
/ Hack-Mag 1 / Hack-Mag - Issue 1 (1990-08-22)(D-Tect)(PD).adf / Soundtracker-Replays / ReadMe.txt < prev    next >
Text File  |  2014-06-19  |  5KB  |  133 lines
  1. * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
  2. *                                                                     *
  3. *              S P R E A D P O I N T   I N   1 9 9 0                  *
  4. *                                                                     *
  5. *                            PRESENTS                                 *
  6. *                                                                     *
  7. *                AMICOM'S SOUNDTRACKER V2.5 PLAYER                    *
  8. *                                                                     *
  9. * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
  10.  
  11.  
  12.  
  13.  WHY DO WE NEED A NEW PLAYER WHEN THERES A PERFECT ONE LIKE STP37 ?
  14. --------------------------------------------------------------------
  15.  
  16. I recently discovered that some modules cannot be played correctly
  17. using stp37. Further investigation showed that this is not due to an
  18. error in the player. The reason is that since Version 2.5, Soundtracker
  19. has some new commands and a new handling for instrument loops.
  20. I tried to adapt the new features to stp37, but the new V2.5 player by
  21. Mahoney and Kaktus is too different from the Spreadpoint 2.4 player.
  22. I therefore started from the beginning and turned the Mahoney/Kaktus
  23. hack into a usable player. It is not as sophisticated as stp37 and
  24. does not have the pipelining feature. Yet it is quite fast, short and
  25. very handy. Not worth mentioning that all stupid shit has been removed
  26. or fixed in just the manner as it has been done from the old Spreadpoint
  27. player to stp37.
  28.  
  29.  
  30.  
  31.      FEATURES / IMPROVEMENTS
  32. -------------------------------------------------------------------
  33.  
  34. -    Fully compatible with SOUNDTRACKER 2.5 incl al new effects.
  35.  
  36. -    DATA (Song Module) may be ANYWHERE IN MEMORY.
  37.     It is not bound to the player.
  38.     You can (as you should) put the player in FAST memory.
  39.  
  40. -    REAL WAIT ROUTINE, using CIA interrupt.
  41.     Runs on every CPU. The delay can be specified in raster lines.
  42.     Does not waste the time (main program runs meanwhile).
  43.  
  44. -    PC-RELATIVE code
  45.     You can copy the routine to anywhere in memory without the need
  46.     of 'relocation' code modification.
  47.     You can even make the routine re-entrant (some changes necessary).
  48.  
  49. -    The following ILLEGAL LAMER-CODING has been fixed
  50.     -  CLR to hardware regs (May crash the system because the 68000
  51.        does a read before the write cycle)
  52.     -  MOVE.B to DFFxyz regs (The interface is 16bit oriented)
  53.     -  the setfilter routine used to always clear the filter bit,
  54.        then set it if required. REPAIRED.
  55.  
  56. -    Code OPTIMIZATION
  57.     Only a few standard optimizations have been made.
  58.     Funny thing in the old player were several TST instructions
  59.     immediately following operations setting the same status.
  60.  
  61. -    RE-INIT works perfectly
  62.     You may at any time, even during play, call mt_init.
  63.     This will always cause the player to restart the song
  64.     at the beginning, without errors or delays.
  65.     Ofcourse you can start playing another song at any time.
  66.  
  67.  
  68.  
  69.  
  70.     HOW TO USE
  71. -------------------------------------------------------------------
  72.  
  73.  
  74. 1)    if yuo're not located in CHIP-memory, allocate regions for the
  75.      the modules you want to use. Copy the sounddata into CHIP memory.
  76.  
  77. 2)    To enable the player
  78.     - allocate a workspace of <mt_enddata> bytes or use a block
  79.       in the code and point A4 to it
  80.     - call 'timerinit'
  81.  
  82. 3)    When you want to play a specific module:
  83.     - write its base address to mt_song(a4)
  84.     - call 'mt_init'
  85.     Also call 'mt_init' when you want to rebegin the current song.
  86.  
  87. 4)    To play the sound, call mt_music as normal, at a rate of
  88.     20 msec for normal speed.
  89.  
  90. 5)    When youre finished playing sound
  91.     - call mt_end
  92.     - then call timerexit
  93.  
  94. 6)    All routines are saving all CPU registers they use.
  95.  
  96. 7)    You need not preserve the status of any hardware register.
  97.     All registers used by the player are automatically
  98.     restored to the values they had on init.
  99.  
  100.  
  101.  
  102.  
  103.     COMPATIBILITY
  104. -----------------------------------------------------------------
  105.  
  106. 1)    The soundtracker is NOT ibm-compatible. (Thank God for that)
  107.  
  108. 2)    It is compatible only with 31 instrument modules. Use the
  109.     soundtracker to upgrade your old 15 intrument modules to the
  110.     new standard.
  111.  
  112. 3)    There is a problem with a few modules for Soundtracker V2.3/2.4
  113.     If a song sounds strange, try it out on Soundtracker 2.4 or older.
  114.     If its sounds wrong only on 2.5, then you must use stp37
  115.     instead of mtp.
  116.  
  117.     As far as we know, everything else should be the same
  118.     as in earlier Spreadpoint players.
  119.  
  120.  
  121.  
  122.  
  123.     BUGS
  124. -----------------------------------------------------------------
  125. Unfortunately, the Mahoney/Kaktus playroutine contains a bug not yet
  126. fixed in mtp08.
  127. It sometimes happens that looped instruments suddenly stop where they
  128. should continue. This seems to happen when the period (pitch) of the
  129. instrument is changed.
  130. If anybody knows the reason for this problem, please contact me or
  131. SPREADPOINT.
  132.  
  133.